home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / xargs.man < prev    next >
Encoding:
Text File  |  1991-09-11  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XARGS                     User Commands                     XARGS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      xargs - construct argument list(s) and execute utility.
  10.  
  11. SSYYNNOOPPSSIISS
  12.      xxaarrggss [[--tt]] [[[[--xx]] --nn nnuummbbeerr]] [[--ss ssiizzee]] [[uuttiilliittyy [[aarrgg ......]]]]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      The _x_a_r_g_s utility reads space, tab, newline and end-of-file
  16.      delimited arguments from the standard input and executes the
  17.      specified _u_t_i_l_i_t_y with them as arguments.
  18.  
  19.      The utility and any arguments specified on the command line
  20.      are given to the _u_t_i_l_i_t_y upon each invocation, followed by
  21.      some number of the arguments read from standard input.  The
  22.      _u_t_i_l_i_t_y is repeatedly executed until standard input is
  23.      exhausted.
  24.  
  25.      Spaces, tabs and newlines may be embedded in arguments using
  26.      single (`` ' '') or double (``"'') quotes or backslashes
  27.      (``\'').  Single quotes escape all non-single quote charac-
  28.      ters, excluding newlines, up to the matching single quote.
  29.      Double quotes escape all non-double quote characters,
  30.      excluding newlines, up to the matching double quote.  Any
  31.      single character, including newlines, may be escaped by a
  32.      backslash.
  33.  
  34.      The options are as follows:
  35.  
  36.      -n number
  37.           Set the maximum number of arguments taken from standard
  38.           input for each invocation of the utility.  An invoca-
  39.           tion of _u_t_i_l_i_t_y will use less than _n_u_m_b_e_r standard
  40.           input arguments if the number of bytes accumulated (see
  41.           the -_s option) exceeds the specified _s_i_z_e or there are
  42.           fewer than _n_u_m_b_e_r arguments remaining for the last
  43.           invocation of _u_t_i_l_i_t_y.  The current default value for
  44.           _n_u_m_b_e_r is 5000.
  45.  
  46.      -s size
  47.           Set the maximum number of bytes for the command line
  48.           length provided to _u_t_i_l_i_t_y.  The sum of the length of
  49.           the utility name and the arguments passed to _u_t_i_l_i_t_y
  50.           (including NULL terminators) will be less than or equal
  51.           to this number.  The current default value for _s_i_z_e is
  52.           ARG_MAX - 2048.
  53.  
  54.      -t   Echo the command to be executed to standard error
  55.           immediately before it is executed.
  56.  
  57.      -x   Force _x_a_r_g_s to terminate immediately if a command line
  58.           containing _n_u_m_b_e_r arguments will not fit in the speci-
  59.           fied (or default) command line length.
  60.  
  61.  
  62.  
  63. Sprite v1.0                    1Q1                              1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XARGS                     User Commands                     XARGS
  71.  
  72.  
  73.  
  74.      If no _u_t_i_l_i_t_y is specified, _e_c_h_o(1) is used.
  75.  
  76.      Undefined behavior may occur if _u_t_i_l_i_t_y reads from the stan-
  77.      dard input.
  78.  
  79.      The _x_a_r_g_s utility exits immediately (without processing any
  80.      further input) if a command line cannot be assembled, _u_t_i_l_-
  81.      _i_t_y cannot be invoked, an invocation of the utility is ter-
  82.      minated by a signal or an invocation of the utility exits
  83.      with a value of 255.
  84.  
  85.      The _x_a_r_g_s utility exits with a value of 0 if no error
  86.      occurs.  If _u_t_i_l_i_t_y cannot be invoked, _x_a_r_g_s exits with a
  87.      value of 127.  If any other error occurs, _x_a_r_g_s exits with a
  88.      value of 1.
  89.  
  90. SSEEEE AALLSSOO
  91.      _e_c_h_o(1), _f_i_n_d(1)
  92.  
  93. SSTTAANNDDAARRDDSS
  94.      The _x_a_r_g_s utility is expected to be POSIX 1003.2 compliant.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0                    2Q2                              2
  130.  
  131.  
  132.  
  133.